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BACKGROUND OF THE INVENTION 

1. Technical Field: 

The present invention is directed to communications 
5 networks. More specifically, , the present invention is 
directed to a method and apparatus for debugging network 
protocol errors using an XML document. 


b 

Q 
Q 

m 
m 


2 . Description of Related Art : 

10 Most network application programs exchange data using 

data packets. Typically, a packet has a specific structure 
that incorporates internal fields that clearly delineate the 
packets' different contents. Using this structural 

representation, a user may devise algorithms that may be 
15 used to effectuate network simulation testing to debug 
network problems etc. The algorithms may be devised using a 
markup language. A markup language is a language that 


w 

P allows additional text or tags that are invisible to users 

m 

p to be inserted into a document. Thus, the tags are not part 

20 of the content of the document but rather enhance the 
document. For example, the tags may be used to structure 
the document or to add hypertext capability to the document 
etc. 

One of the markup languages that is particularly well 
25 suited for this task is the extensible Markup Language or 
XML. XML is a language that is especially designed for Web 
documents. It allows designers to create their own 
customized tags, enabling definition, transmission, 
validation, and interpretation of data between applications 
30 and between organizations. 

Consequently, what is needed is an apparatus and method 
of using XML documents to diagnose network protocol errors. 
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SUMMARY -OF THE- INVENTION 


)resent invention provides 


r hod, — syst e m — arrdj 


apparatus for diagnosing network protocol errors lisirT^"^ an 
XML document. Data packet exchanges arex^a-prCured and used 
to generate an XML document .^^^Ji^r^'one embodiment, the XML 
document is passed tJ:iJ?eTl^n parser to diagnose the errors. 
In another>-eiTtBodiment, the network protocol errors are 


lo.sfid by visually inspecting the XMX^ (^omm^ni.^^ 
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BRIEF DESCRIPTION OF THE DRAWINGS 


The novel features believed characteristic of the 
invention are set forth in the appended claims. The 
invention itself, however, as well as a preferred mode of 
use, further objectives and advantages thereof, will best be 
understood by reference to the following detailed 
description of an illustrative embodiment when read in 
conjunction with the accompanying drawings, wherein: 

Fig. 1 is an exemplary block diagram illustrating a 
distributed data processing system according to the present 
invention. 

Fig. 2 is an exemplary block diagram of a server 
apparatus according to the present invention. 

Fig. 3 is an exemplary block diagram of a client 
apparatus according to the present invention. 

Fig. 4 depicts a TCP/IP data packet. 

Fig. 5 depicts a TCP header format. 

Fig. 6 is a sample XML document. 

Fig. 7 depicts added elements to the sample XML 
document in Fig. 6. 

Fig. 8 depicts an XML document representing generic 
packet exchanges of a TCP/IP setup connection. 

Fig. 9 is a flow chart of a program that may be used to 
generate an XML document of a generic TCP/IP setup 
connection. 

Fig. 10 is a flow chart of a process that may be used 
to implement a parser to parse an XML document. 

Fig. 11 depicts an XML schema for a generic TCP/IP 
setup connection. 

Fig. 12 depicts an XML document representing packet 
exchanges for a generic TCP/IP close connection process. 
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Fig. 13 is a flow diagram of a program that may be used 

._ tp__cfenera.t.e. „an_ XML_ _dO-C.ument- _ f o.r-_a -gener-ic- -a — TCP-/-tP -G-l-ose- 

connection process. 

Fig. 14 is a flow diagram of a parser that may be used 

5 to notify a user whether a generic close setup connection 

was successful. 

Fig. 15 depicts an XML schema for packet exchanges in a 

generic TCP/IP close setup connection. 

Fig. 16 depicts packet exchanges for a TCP/IP login 

10 setup connection. 

|«i Fig. 17 an XML document of the TCP/IP login setup 

Q 

S connection. 

Q 

g3 Fig. 18 is a high level output of a parser that has 

m 

p parsed a TCP/IP data transaction from establishing a 

SI 15 connection to closing the connection. 

t 

Fig. 19 is a first example of an XML document 


^ representing a generic TCP/IP setup connection that has not 

m 

^ been well formed. 

,61 Fig. 20 is a second example of an XML document 

20 representing a generic TCP/IP setup connection that has not 
been well formed. 
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DETAILED DESCRIPTION OF THE PREFERRED EMBODIMENT 


With reference now to the figures, Fig. 1 depicts a 
pictorial representation of a network of data processing 
5 systems in which the present invention may be implemented. 
Network data processing system 100 is a network of computers 
in which the present invention may be implemented. Network 
data processing system 100 contains a network 102, which is 
the medium used to provide communications links between 
10 various devices and computers connected together within 
y> network data processing system 100. Network 102 may include 

n 

PI connections, such as wire, wireless communication links, or 

P fiber optic cables. 

|sj In the depicted example, server 104 is connected to 

SI 15 network 102 along with storage unit 106. In addition, 

'"^ clients 108, 110, and 112 are connected to network 102. 

P 

These clients 108, 110, and 112 may be, for example, 

m 

personal computers or network computers. In the depicted 
01 example, server 104 provides data, such as boot files, 

20 operating system images, and applications to clients 108, 
110 and 112. Clients 108, 110 and 112 are clients to server 
104. Network data processing system 100 may include 
additional servers, clients, and other devices not shown. 
In the depicted example, network data processing system 100 

25 is the Internet with network 102 representing a worldwide 
collection of networks and gateways that use the TCP/IP 
suite of protocols to communicate with one another. At the 
heart of the Internet is a backbone of high-speed data 
communication lines between major nodes or host 
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computers, consisting of thousands of commercial, 
go_vernment, ...educational -and— other- computer - systems -that 
route data and messages. Of course, network data processing 
system 100 also may be implemented as a number of different 
types of networks, such as for example, an intranet, a local 
area network (LAN), or a wide area network (WAN). Fig. 1 is 
intended as an example, and not as an architectural 
limitation for the present invention. 

Referring to Fig. 2, a block diagram of a data 
processing system that may be implemented as a server, such 
as server 104 in Fig. 1, is depicted in accordance with a 
preferred embodiment of the present invention. Data 
processing system 200 may be a symmetric multiprocessor 
(SMP) system including a plurality of processors 202 and 204 
connected to system bus 206. Alternatively, a single 
processor system may be employed. Also connected to system 
bus 206 is memory controller/cache 208, which provides an 
interface to local memory 209. I/O bus bridge 210 is 
connected to system bus 206 and provides an interface to I/O 
bus 212, Memory controller/cache 208 and I/O bus bridge 210 
may be integrated as depicted. 

Peripheral component interconnect (PCI) bus bridge 214 
connected to I/O bus 212 provides an interface to PCI local 
bus 216. A number of modems may be connected to PCI local 
bus 216. Typical PCI bus implementations will support four 
PCI expansion slots or add-in connectors. Communications 
links to network computers 108, 110 and 112 in Fig. 1 may be 
provided through modem 218 and network adapter 220 connected 
to PCI local bus 216 through add-in boards. 
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Additional PCI bus bridges 222 and 224 provide interfaces 
f or ^additioaa.l _P-C.I_, local- buses- -22-6 -and— 2-28^ — f-rom -wh-ich — - 

additional modems or network adapters may be supported. In 

this manner, data processing system 200 allows connections 
5 to multiple network computers. A memory-mapped graphics 

adapter 230 and hard disk 232 may also be connected to I/O 

bus 212 as depicted, either directly or indirectly. 

Those of ordinary skill in the art will appreciate that 

the hardware depicted in Fig. 2 may vary. For example, 
10 other peripheral devices, such as optical disk drives and 

the like, also may be used in addition to or in place of the 

hardware depicted. The depicted example is not meant to 

imply architectural limitations with respect to the present 

invention. 

15 The data processing system depicted in Fig. 2 may be, 

for example, an IBM e-Server pSeries system, a product of 
International Business Machines Corporation in Armonk, New 
York, running the Advanced Interactive Executive (AIX) 
operating system or LINUX operating system. 

20 With reference now to Fig. 3, a block diagram 

illustrating a data processing system is depicted in which 
the present invention may be implemented. Data processing 
system 300 is an example of a client computer. Data 
processing system 300 employs a peripheral component 

25 interconnect (PCI) local bus architecture. Although the 
depicted example employs a PCI bus, other bus architectures 
such as Accelerated Graphics Port (AGP) and Industry 
Standard Architecture (ISA) may be used. Processor 302 and 
main memory 304 are connected to PCI local bus 306 through 

30 PCI bridge 308. PCI bridge 308 also may include an 
integrated memory controller and cache memory for processor 
302. Additional connections to PCI local bus 306 may be 

- 8 - 
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made through direct component interconnection or through 

_ add:^n_ boards . In _the. depicted -examp-l-e,- 4oGa-l--a-rea- net-work 

(LAN) adapter 310, SCSI host bus adapter 312, and expansion 
bus interface 314 are connected to PCI local bus 306 by 
5 direct component connection. In contrast, audio adapter 
316, graphics adapter 318, and audio/video adapter 319 are 
connected to PCI local bus 306 by add-in boards inserted 
into expansion slots. Expansion bus interface 314 provides 
a connection for a keyboard and mouse adapter 320, modem 
10 322, and additional memory 324. Small computer system 
1^* interface (SCSI) host bus adapter 312 provides a connection 

few? 

p for hard disk drive 326, tape drive 328, and CD-ROM drive 

p 330. Typical PCI local bus implementations will support 

Q three or four PCI expansion slots or add-in connectors. 

1 15 An operating system runs on processor 302 and is used 


to coordinate and provide control of various components 
within data processing system 300 in Fig. 3. The operating 


Q system may be a commercially available operating system, 

such as Windows 2000, which is available from Microsoft 

^ 20 Corporation, An object oriented programming system such as 
Java may run in conjunction with the operating system and 
provide calls to the operating system from Java programs or 
applications executing on data processing system 300. 
^'Java'' is a trademark of Sun Microsystems, Inc. 
25 Instructions for the operating system, the object-oriented 
operating system, and applications or programs are located 
on storage devices, such as hard disk drive 326, and may be 
loaded into main memory 304 for execution by processor 302. 
Those of ordinary skill in the art will appreciate that 
30 the hardware in Fig. 3 may vary depending on the 
implementation. Other internal hardware or peripheral 
devices, such as flash ROM (or equivalent nonvolatile 
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memory) or optical disk drives and the like, may be used in 
_addi.ti.Qn_to__or_..in._place--o.f -the--hardwa-re depicted- -in— Fi-g-^- -3— 
Also, the processes of the present invention may be applied 
to a multiprocessor data processing system. 

As another example, data processing system 300 may be a 
stand-alone system configured to be bootable without relying 
on some type of network communication interface, whether or 
not data processing system 300 comprises some type of 
network communication interface. As a further example, data 
processing system 300 may be a Personal Digital Assistant 
(PDA) device, which is configured with ROM and/or flash ROM 
in order to provide non-volatile memory for storing 
operating system files and/or user-generated data. 

The depicted example in Fig. 3 and above-described 
examples are not meant to imply architectural limitations. 
For example, data processing system 300 may also be a 
notebook computer or hand held computer in addition to 
taking the form of a PDA. Data processing system 300 also 
may be a kiosk or a Web appliance. 

The present invention provides an apparatus and method 
of diagnosing network protocol errors using XML documents. 
The invention may be local to client systems 108, 110 and 
112 of Fig. 1 or to the server 104 or to both the server 104 
and clients 108, 110 and 112. Consequently, the present 
invention may reside on any data storage medium (i.e., 
floppy disk, compact disk, hard disk, ROM, RAM, etc.) used 
by a computer system. 

The bulk of communications occurring over the Internet 
is done using TCP/IP (Transmission Control Protocol/Internet 
Protocol) . Accordingly, the present invention will be 
described using TCP/IP. Nonetheless, it should be 

understood that the invention is not restricted to only 


- 10 - 


Docket No. AUS920010869US1 


TCP/IP. Any other type of network communication protocol 

may_be_ xised_and_ would, be. -well --within -the -scope -and -spiri-t -of 

the invention. 


0 

m 


5 OVERVIEW OF INTERNET COMMUNICATIONS 

Since TCP/IP will be used to explain the present 
invention, a general description of TCP/IP is therefore 
warranted. The TCP/IP protocol is typically implemented as 
a layered protocol stack where data packets are processed 
10 layer by layer. As an example, a typical network 
transaction using TCP/IP is the transfer of e-mail messages 
over the Internet. For a user to send an e-mail message to 
a recipient, the user has to fill in the e-mail address of 
the recipient and type in the text of the message. Then, 


15 the user has to assert the '"send" button, 


p When the ^^send" button is asserted, the text of the 

message (or the message) is sent to a TCP layer. If the 
1*3 message is too long, for example when a large file is 

attached to the message, the TCP layer will break the 

20 message up into datagrams or data packets and adds a header 
in front of each data packet. The TCP header will be 
described later. The TCP layer will then send each data 
packet (including the added header) to an IP layer. The IP 
layer then puts an IP header to the data packet that 

25 includes a source IP address and a destination IP address. 
Using the IP addresses, each data packet will then be sent 
to the recipient over the Internet. 

Fig. 4 depicts each data packet that is transmitted 
over the Internet. As stated above, TCP header 405 is first 

30 added to user data 410 (e.g., data packet). Then, IP header 
400 is added. Once this is completed, the data packet is 
allowed to enter the Internet. The IP header ensures that 
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the data reaches the target computer system while at the 

sameL t.ime_it _l_ets-_the_tar-get- -system--know—w-hexe— the -message 

originates. In the case of accessing Web pages, the IP 
application protocol may be regarded as the application 
5 program that opens up a communication line between the two 
computer systems so that data may be transmitted back and 
forth. 

Upon receiving a data packet, the target computer 
system sends the packet to an IP layer where the IP header 
10 is stripped off. The resulting data packet is then sent to 
a TCP layer. The TCP layer then strips the TCP header off 
the packet and collects all the packets in order to 
reconstruct the message. Once reconstructed, the message is 
sent to a mail application protocol. Using the e-mail 
15 address of the intended recipient, the mail application 


4 

9 protocol then puts the message into the mailbox of the 


recipient. 


TCP HEADER 


20 Since the IP header is not important to explain the 

invention, it will not be described. The TCP header will 
now be briefly described. Fig. 5 depicts a TCP header 
format. The first two bytes of the TCP header is 16-bit 
source port number 500. The next two bytes of the TCP 

25 header is the 16-bit destination port number 505. The port 
numbers are used to keep track of different conversations. 
For example, if a server is communicating with three 
different clients, the server will use a particular port 
number to communicate with each one of the clients. Thus, 

30 the 16-bit source port number 500 and the 16-bit destination 
port number 505 in conjunction with the IP address in the IP 
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header identify a unique connection. This unique connection 
_i.s -Often -xeferxed- to as- a socket . 

Each datagram or data packet has a 32-bit sequence 
number 510. The sequence number is used to let the 
receiving computer system know the order of the particular 
packet in the stream of packets. It is also used by the 
receiving computer system to notify the sending computer 
system that all packets have been received up to a certain 
number. TCP does not number the datagrams but rather 
numbers the octets (8-bit data) in each datagram. Thus, if 
there are 500 octets in each datagram or packet, the first 
datagram may have a sequence number of ^"0", the second 
^^500", the third ^^1000" etc. 

In order to ensure that a datagram has been received, 
the recipient has to send back a 32-bit acknowledgement 
response to the sender. For example, if a recipient sends 
an acknowledgement of 1500, it is telling the sender that it 
has received all the data up to octet number 1500. If the 
sender does not get an acknowledgement response within a 
pre-determined time, it will resend the data. When a data 
sender receives a new value, it can dispose of data that was 
held for possible re-transmission. The acknowledgement 
number is only valid when ACK flag 530 is set. 

The 16-bit window size 555 represents the number of 
bytes starting with the byte specified in the 
acknowledgement number field 510 that the receiver is 
willing to accept. Stating differently, the window is used 
to control how much data can be in transit at any one time. 
It, in a way, advertises the amount of buffer space that has 
been allocated for the connection. The window size is used 
because it is not practical to wait for each datagram to be 
acknowledged before sending the next one, lest data 
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transactions over the Internet may be too slow. On the 

0-ther„ hand,- -a sender -cannot-- ^ust— keep — sending— data-, — or -a- 

fast computer system might overrun the capacity of a slow 
one. Thus, each computer system indicates how much new data 
5 it is currently prepared to absorb by putting the number of 
octets in its 16-bit window. As a recipient receives data, 
its window size will decrease until it reaches zero (0) . At 
that point, the sender has to stop. As the receiver 
processes the data, it will increase its window size 
10 signaling that it is able to accept more data. Often times, 

^ the same datagram may be used both to acknowledge receipt of 

n 

g a set of data and to give transmission permission for 

Q additional new data. 

P The 4-bit header length 520 indicates the size of the 

H 15 entire TCP header. In Fig. 5, options, padding, reserve and 

Jif7 

a few other fields are not shown. The options field depends 
H on the number of options set and thus is of variable length. 

g| Accordingly, there is not a pre-determined length for the 

HI TCP header. Hence, the length of each header has to be 

'^^ 20 indicated. 

When one-bit URG 525 is used, it indicates that the 32- 
bir urgent pointer field 565 is valid. As mentioned before, 
when one-bit ACK 530 is set, the 32-bit acknowledgement 
number 515 is valid. One-bit PSH 535 is used to instruct 
25 the receiver to pass the data received thus far immediately 
to the receiving application. RST 540 is used to tell the 
receiver to re-establish connection. This usually indicates 
that an error condition has been detected. SYN bit 545 
synchronizes the sequence numbers to begin a connection and 
30 FIN bit 550 indicates that the sender has sent all data in a 
stream. If both ends of a communication have sent the FIN 
flag, the connection will be closed. 
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The 16-bit checksum 560 ensures that the TCP header and 

_ _data ha-v_e_ not _been -modi-f ied— in t-rans-i-t-. - I-:^-the— eheek-s-um- i-s— 
invalid, the receiver will not acknowledge the message. The 
value in 16-bit urgent pointer 565 points to the end of data 
field that is considered urgent and requires immediate 
attention. This field is not valid if URG bit 525 is not 
set . 

ESTABLISHING A TCP/IP CONNECTION 

To establish a TCP connection, an active computer 
system (e.g., a client) has to initiate communication with a 
passive computer system (e.g., a server) by sending a SYN 
packet (i.e., a packet with SYN bit 545 set) with the 
sequence number 510 set to an arbitrary value J. The server 
will then respond with a SYN, ACK packet (i.e., both the SYN 
bit 545 and the ACK bit 530 are set) with the 
acknowledgement number 515 set to J+1 and the sequence 
number 510 set to a further arbitrary number K. The client 
then responds to the SYN, ACK packet with an ACK packet with 
the acknowledgement number set to K+1. Note that in this 
case, both K and J are integers. Note also that only the 
parameters of importance for the connection to be 
established are described. However, other parameters . such 
as window size etc. will also be included in the packets. 
Once the connection is established, user data packets may 
then be transmitted. 

The above scenario may be interpreted as the client and 
server negotiating parameters such as window size etc. to 
use when transferring the user data packets. The smaller of 
the two parameters are used to actually transmit the user 
data. 


- 15 - 


Docket No. AUS920010869US1 


CLOSING A TCP/IP CONNECTION 

— T-he — -TCP-/-IP --GonneotioH may - -be ciosed when — the- 

application program running on the client makes a close () 
system call on the open socket. When this occurs the client 
will send a FIN packet (i.e., the FIN bit 550 set) to the 
server with the sequence number 510 set to J. When the 
server receives the FIN packet, it passes an ''end-of-f lie" 
indication to the software. At that time, the server will 
send an ACK packet to the client with the acknowledgement 
number 515 set to J+1. The server will again send another 
packet, a FIN packet to the client with the sequence number 
set to K. The client will then respond with an ACK packet 
with a K+1 acknowledgement number. The TCP connection will 
then be closed. 

Note that there are many existing methods of closing a 
TCP/IP connection. The method outlined above is the most 
often used method. 

BRIEF DESCRIPTION OF AN XML DOCUMENT 

Fig. 6 is an example of an XML document. The header 
of the document tells a user that this is an XML document 
that has been written using version 1.0 of the XML 
specification. The greater than (^'>") and the less than 
(^^<") signs are tags. They indicate the opening and closing 
of an element. Elements are the basic building blocks of an 
XML document. They may contain text, comments, or other 
elements. Every opening element (i.e. ''<company>") must 
also contain a closing element (i.e. ''</company>") . The 
closing element consists of the name of the opening element, 
prefixed with a slash CV) . 

XML is case-sensitive. While ''<company ></company>" is 
well-formed, ''<COMPANY></ company >" and "<Company></cOMPANY 
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>" are not. Also, if the element does not contain text or 

^o t her. -el erne nt s.,. -the c 1 o s i n g -t a g— ma y -b e -a bb r e v-i-a fe e d- by— s i-mp l-y 

adding a slash ("V") before the closing bracket in the 
element (e.g., ^^<company></company>" can be abbreviated as 
5 ''<company />") . In addition to the rules defining opening 
and closing tags, it is important to note that in order to 
create a well-formed XML document, the elements must be 
properly nested. 

All attribute values must be contained within quotation 
10 marks. For example, id="l" is correct, while id=l is not 
acceptable. Where elements represent the nouns contained in 
P an XML document, attributes represent the adjectives that 

2 describe the elements. 

Q Thus in the XML of Fig. 6, a company and two of its 

15 employees are defined. The relationship between the company 


4^ 

u 

tlj 


(parent) and the employees (children) are also described. 
Note that new employees can easily be added. Fig. 7 depicts 
P elements that are added to the example of Fig. 6. 

si 


In summary, XML is a text-based meta-language that uses 
20 tags, elements, and attributes to add structure and 
definition to documents. It is a markup language because it 
uses tags to mark-up documents and it is a meta-language 
because it uses the tags to give structure to documents that 
is in turn used as a means of communication. XML is 
25 extensible because it enables users to create their own 
collection of tags. 

GENERATING AN XML DOCUMENT TO REPRESENT TCP/IP DATA 
TRANSACTIONS 

30 Knowing the connection establishment, the transition 

state of each user data packet and the close connection 
procedures of TCP as well as the rules required to implement 
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an XML document, a software program may be written to 
conv_ert- T-CP- data --transactions i-nto an —XML — document-. -T-he- 
document may then be sent to an XML parser to investigate 
network communications problems. Both the software program 
and the parser may be written in C++, Java or any other 
suitable programming language. The TCP/IP transactions may 
be acquired through an existing application program such as 
TCPdump, IPtrace, IPreport etc. or through a network 
sniffer. A network sniffer is a program or device that 
monitors data traveling over a network communications line. 

Fig. 8 depicts an XML document representing a generic 
TCP/IP connection setup. As mentioned earlier, the TCP/IP 
connection setup uses three data packets, each packet of 
course contains an IP header and a TCP header. In the 
example of the TCP/IP connection above, the IP header and 
the TCP header are taken into consideration only once. 
Nonetheless, the IP header and TCP header of each packet are 
thoroughly examined for relevant information. For example, 
all invariant header attributes such as port numbers and IP 
addresses may be captured as attributes of the header tag. 
In any case, the IP_header is a parent element that contains 
a child element ''TCP_header" . The ''TCP_header'' element in 
turn contains child element ^'TCP_connection" and the 
''TCP_connection" contains children elements ''SYN_sent", 
''SYN_received", ''ACK_received" and ''ACK_sent". 

Fig. 9 is a flow chart of a program that may be used to 
generate the XML document of the TCP/IP connection setup 
described above. This flow chart assumes that all the data 
packets have an IP header and a TCP header. Of course, a 
program may be written to determine that it is indeed so. 
In any case, assuming that there are both an IP header and a 
TCP header, the present program will ensure that an IP 
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a 

m 


header element and a TCP header element are opened and 

^clos-ed- -in- -accordance — ^wlth -the- above- example-. Note -- feha-t- 

here, only the first three packets are taken into 
consideration since per TCP/IP specification the first three 
5 packets in any TCP/IP transactions are used to establish a 
TCP/IP connection. 

The process starts when the program begins to execute 
(step 900) . When the program gets the first packet, it 
determines whether the SYN flag bit 545 is set. If it is 
10 not set, the program will go on looking at the next packet 
in the stream of packets to determine if the SYN bit is set 
in that packet (steps 902 and 904) . The first packet may 
not have the SYN bit set if, for instance, it is not part of 
the TCP/IP transactions being investigated. To ensure that 


SI 15 the packet is part of the TCP/IP transactions being 

J"'* investigated the program may take into consideration the IP 

H addresses in the IP header as well as the port numbers in 

ill 

g the TCP header. 

.01 Note that the two IP addresses and the two port numbers 

j^J; 20 will alternate based on the computer system that sends the 
data packet. For example, when the client sends a packet, 
its IP address will be the source IP address and the IP 
address of the server will be the destination IP address. 
If, on the other hand, the server sends the packet, its IP 
25 address will be the source IP address and the IP address of 
the client will be the destination IP address. Likewise, 
when the client sends the packet the port number that it is 
using for the connection will be the source port number and 
the port number that the server is using for that particular 
30 connection will be the destination port number. The source 
and destination port numbers will be reversed when the 
server sends the packet. 
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After ensuring that the packet is the first one in the 
-trans aet-ion-s- -and —the- -S-Y-N--bi-t — i-s — ^no-t-— set — ^then- the— p-rog-ram- 


will not open and close the SYN_sent element in the XML 

document being generated. If the SYN bit is set, the 

5 SYN_sent element will be opened and closed (steps 902 and 

906) . Next a check will be made to determine whether there 

is a sequence number in the packet. If so, the number will 

be inserted between the opened and closed SYN_sent element. 

If not, a number will not be inserted (steps 908, 910 and 

10 912) . The next packet will then be investigated to 

determine whether both the SYN flag and the Ack flag are 

U set. If so, a SYN received and an ACK received element will 

P - 

Q be opened and closed. Next, checks will be made as to 

1^ whether there are a sequence number and an acknowledgement 

\j 15 number. If so, the sequence number will be inserted between 
the opened and the closed SYN received element and the 
acknowledgement number between the opened and closed 
|j ACK_received element (steps 916, 918, 920, 922, 924, 926, 

01 928, 930 and 932) . 

20 The next packet will be checked to see whether the ack 


flag is set. If so, the ACK_sent element will be opened and 
closed and the acknowledgement number will be inserted 
between the opening and the closing tags of the ACK_sent 
element if one exists (steps 936, 938, 940, 942, 944 and 

25 946) . The execution of the program then ends (step 948) . 

A parser may be implemented to notify a user as to 
whether the TCP/IP connection sequence was proper. Fig. 10 
is a process that may be used to implement the parser. In 
this case, the XML document generated above will be fed into 

30 the parser. The process starts with the execution of the 
parser (step 1000). The parser will check to see whether 
there are a SYN sent element and a sequence number between 
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the opened and closed SYN_sent element. If not, an 

. appropriate —error— -message - may - be -generated- - -(-steps — ^1-00-2 j- 

1004, 1006 and 1008). Then the parser will check to 
determine whether there are a SYN_received 'element and a 
5 number between the opened and closed SYN_received element. 
If not, an appropriate error message may be generated (steps 
1010, 1012, 1014 and 1016). The parser will continue to 
check to see whether there are an ACK_received element and 
an ACK_sent element, whether there is a number between the 
10 opened and closed ACK_received and ACK_sent elements and 
whether these two numbers are the expected numbers. If not, 
P appropriate messages may be generated; otherwise, a 

Q ^'connection setup successful" message may be generated 

|l (steps 1018 - 1042) . 

\| 15 For the application presenting the XML document to the 

user to properly interpret the markup tags, a schema must be 
1^ developed- As alluded to before, the purpose of an XML 

W schema is to define and describe a class of XML documents by 

using schema components to constrain and document the 
20 meaning, usage and relationships of the constituent parts of 
the documents. Schemas may also provide for the 
specification of additional document information, such as 
normalization and default attribute and element values. 
Schemas have facilities for self -documentation. Thus, an 
25 XML schema can be used to define, describe and catalogue XML 
vocabularies for classes of XML documents. 

Fig. 11 depicts an XML schema for the generic TCP/IP 
setup connection. In the schema, IP_header, TCP_header, 
SYN_sent, SYN^received, ACK_received and ACK_sent are all 
30 defined as elements. Their types are also defined (e.g., 
complextype or simpletype) • In this case, '"ref" is used for 
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CP 


simpletype. Sequence is a compositor that defines an 

—ordered sequence - of- -sub-elemen-ts— or -chi-l-dren-. Note- t-ha-t- 

each element that is opened is also closed. Note also that 
the schema is developed based on the state transition of the 
5 packets being transmitted (i.e., SYN, SYN&ACK and ACK 
packets) . Thus, a schema may be developed for any packet 
state transitions. Once a schema is developed, the entries 
in the XML document may correctly be interpreted. 

Note that an XML document may be generated for all data 
10 packets including the packets used during the TCP/IP close 
connection sequence. As before, an XML schema must be 
developed to correctly interpret the elements. 

Fig. 12 depicts an XML document representing a generic 
TCP/IP close connection sequence. As with the TCP/IP setup 
15 connection process, a program may be written to 
u automatically generate the XML document of the close 

connection sequence. In this case, a check will be made to 
ensure that both ends of the TCP/IP connection have sent a 
FIN packet. If so, the program will ensure that the proper 
20 elements are opened and closed if they are present and 
numbers are inserted in the proper place if present just as 
was done in the TCP/IP connection setup. A parser may be 
generated to notify the user as to whether the close 
connection process was properly executed. If not, 

25 appropriate error messages will be generated. Otherwise, a 
''close connection setup successful" may be generated. 

Fig. 13 is a flow diagram of a program that may be used 
to generate the XML document outlining the TCP/IP close 
connection setup. The program will check to ensure that 
30 both ends of the network transaction have sent a FIN packet 
as per the XML specification. If so, then the TCP/IP 
connection is being closed. Consequently, the program will 
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ensure that the four packets, starting with the first FIN 
packet.,, are the -proper packets and the program will open and 
close a FIN_sent element, an ACK_received element, a 
FIN_received element and an ACK_sent element and the 
5 appropriate numbers will be inserted between each open and 
close element (steps 1300 - 1354) . 

Fig. 14 is a flow diagram of a parser that may be used 
to notify the user whether the close setup connection was 
successful. The parser will ensure that all the open and 
10 close elements are present and in the proper sequence in the 
XML document. The parser will also ensure that the proper 
p numbers are inserted between an open and close element. If 

0 there is any discrepancy between what is expected and what 

6"^ is actually in the document, the parser may generate an 

.S3 

15 error to notify the user (steps 1400 - 1440) . 


ill 


Again a schema needs to be generated to validate the 
XML document representing the close connection sequence. 


Fig. 15 is a schema for the close connection sequence. 


The TCP/IP setup connection process in Fig. 8 was for a 


0 20 generic connection. Fig. 15 depicts a TCPdump for a TCP/IP 
packet exchange for a remote login connection setup. A 
TCPdump is publicly available program that captures and 
outputs the TCP packet exchanges between two end points of a 
network connection. Each line in Fig. 16 represents a 

25 packet. The first line (first packet) may be deciphered 

as TCP port 1023 on host ''gil" sending a SYN packet to the 
login port on host ^'devo". The sequence number is 7 68512 
and contained no data. The window size is set at 4096 and 
the maximum segment size is 1024. In the second line 

30 (second packet) host ''devo" replied with a SYN, ACK packet. 
The sequence number is 947648 and it also contained no data. 
The acknowledgement number is 768513 which acknowledges the 
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afore-said SYN packet. The window size is 4096 and maximum 

segmen-t-s-i-ze--l-02-4-— - In— the— trMrd--l-ine- (-i . e^y third-packet-)- 

^'gil" responded with an ACK packet and the acknowledgement 
number is 947649 and window size is 4096. At that point the 
5 connection is opened. 

The XML document representing this specific TCP/IP 
connection setup is illustrated in Fig. 17. Here, 
attributes to the TCP_header are local and remote ports 
(i.e., 1023 and login), local and remote IP addresses (i.e., 
10 gil and devo) and the application initiating the TCP/IP 
setup connection (i.e., rlogin) . Note that the IP addresses 
p are expressed in terms of the names of the computer systems, 

p It is well known in the field that if the name of a computer 

p system is known, its IP address may easily be obtained. 

N 15 In this case, the reverse address resolution protocol 

(RARP) may be used to find the IP address. ARP (address 
resolution protocol) is the protocol used by TCP/IP to 
P convert a physical address into an IP address. A computer 

system wishing to find out an IP address of another computer 
j^^ 20 system broadcasts an ARP request onto the network. A 
computer system on the network that has the IP address 
responds with its physical address. RARP, on the other 
hand, is used to obtain a computer system's own IP address. 
A computer system wishing to find out its own IP address 
25 broadcasts its own physical address on the network and the 
RARP server (the server that assigns IP addresses to the 
computer systems in the network) will reply with the 
computer system's IP address. 

In any case, a program may be written to generate the 
30 specific TCP/IP connection outlined above. Furthermore, a 
parser may be written to investigate any network 
communications problem that a user may encounter. 
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As with the TCP/IP setup connection, based on the state 

transition- -diag-ram- -of ~t-hi-s- -speci-f i-e— T-G-P/I-P- -connect i-on> - an— - 

XML schema may be developed for proper interpretation of the 
elements . 

5 An XML document for user data may also be generated. 

This would include the TCP/IP setup connection, user data 
packet transactions and the close connection sequence. Of 
course, an XML schema will also have to be developed for 
proper interpretation of the elements used. When the 
10 document is passed through an appropriate parser, if no 
errors are encountered, the parser may generate an output 
such as that depicted in Fig. 18. Note that this is a high 
level view of the output of the parser. 

15 DEBUGGING 

As mentioned in the discussion above, a parser may be 
developed to investigate communications errors. The parser 
uses as input the XML document representing the packets 
exchanges. If the XML document is well formed, then there 

20 are not any network communications errors. If the document 
is not well formed, the parser will pinpoint the errors. 
Figs. 19 and 20 depict two XML documents. Based on the 
specification of the TCP/IP setup connection, both XML 
documents are not well formed. Therefore, the TCP/IP 

25 connections would not have been established. In Fig. 19, 
the SYN_Received element comes before the SYN_Sent element. 
This indicates then that the packets were not exchanged in 
the order specified in the specification and thus the reason 
why the connection was not established. A parser (e.g., 

30 Fig. 7) should quickly point that out. 
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The second XML document is missing the SYN_Sent packet 

altogether^. — Again-, -the— pa-r-se-ir -shouid poi-n-t -th-is- fact-as -the- 

reason the connection was not established. In addition, 
neither one of the two XML documents would be validated 
5 against the connection setup schema described above as the 
elements do not follow the proper sequence in the schema. 

Note also that the parser will ensure that the proper 
numbers are present. For example, when setting up and 
closing a TCP/IP connection, the ACK number sent should be 
10 the sequence number received plus one. If this is not so, 
the parser will notify the user of the discrepancy, 
p Thus, when network data transactions are expressed 

p using XML documents, investigations of network 

P communications errors are greatly simplified. Indeed, a 

15 user may merely look at the generated document (i.e., a 


a 

0 


parser need not be used) to uncover the errors. 
SIMULATION 

Furthermore, a user may use the XML documents to 
20 perform network protocol simulation. Clearly, any change 
made to the XML document is in effect a change made to the 
packet exchanges. Consequently, using the XML documents a 
user may analyze the properties of the packets, modify as 
well as create new exchanges and study the effects of the 
25 changes on the packets. Thus, performance modeling and 
analysis may easily be performed using XML documents. 

By modifying the network protocol's state transition 
diagram, the user can cause subtle/major changes in network 
behavior, traffic pattern, response pattern, response time, 
30 congestion etc. Through network behavior analysis the user 
can visualize and analyze the effects of the modification. 
This can be illustrated graphically, for example. XML is a 
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useful tool for such analysis and using the technique 

describe^ here wi_l]^_ . l_e.ad _ .to. —a — simple — meehani-sm -- f or- 

specif ication of protocol behavior and the corresponding 
simulation and analysis of the behavioral response pattern. 

The description of the present invention has been 
presented for purposes of illustration and description, and 
is not intended to be exhaustive or limited to the invention 
in the form disclosed. Many modifications and variations 
will be apparent to those of ordinary skill in the art. The 
embodiment was chosen and described in order to best explain 
the principles of the invention, the practical application, 
and to enable others of ordinary skill in the art to 
understand the invention for various embodiments with 
various modifications as are suited to the particular use 
contemplated . 
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